You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The project did not have a dedicated testing utilities package. Developers lacked a centralized place for fixtures, matchers, transaction log inspectors, and local validator setup when writing tests for Solana programs.
Summary of Changes
Created new package: packages/testing to house testing utilities.
Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.
This PR includes no changesets
When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types
These fixtures are meant for consumers of the Gill packages — to help them write TypeScript tests for their own Solana programs and integrations.
For example, you can see them in action testing an Anchor escrow program here: example link
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The project did not have a dedicated testing utilities package. Developers lacked a centralized place for fixtures, matchers, transaction log inspectors, and local validator setup when writing tests for Solana programs.
Summary of Changes
Created new package:
packages/testingto house testing utilities.Added Local Validator utilities
startLocalValidator({ airdropLamports?, programs?, resetLedger? }) → { rpc, ws, payer, close }Added Fixtures
createFundedKeypair(rpc, lamports?)createMint(rpc, { decimals?, mintAuthority?, freezeAuthority? })ensureAta(rpc, { owner, mint })mintTo(rpc, { mint, toOwner, amount, ensureAta? })setupFungibleToken(rpc, payer, { owner, decimals?, amount })Added Tx Log Inspector utilities
inspectTransaction(rpc, signature)→{ signature, slot, status, computeUnits?, logs[], accountsTouched[] }findCustomError(logs),totalComputeUnits(logs),listCpiCalls(logs)Added Matchers
expectTxToSucceed(rpc, signature)expectTxToFailWith(rpc, signature, { code|name|messageIncludes })expectAccountToExist(rpc, address)Organized source under
src/with subfoldersfixtures/,localValidator/,matchers/,txLogInspector/